home *** CD-ROM | disk | FTP | other *** search
/ Super Shareware Collection / Super Shareware Collection.iso / os_2 / zipctl.zip / README.DOC < prev    next >
Text File  |  1994-02-01  |  12KB  |  270 lines
  1.  RPF Zip Control(TM) Copyright 1993 RPF Software ALL RIGHTS RESERVED
  2.  
  3.  Abstract
  4.  --------
  5.  Zip Control is an OS/2 program which uses a PM interface to access
  6.  the freeware program UNZIP.EXE.  UnZIP is a command line program which
  7.  is compatible with version 2 of the DOS PkZIP program.  UnZIP is
  8.  available as freeware on many BBS's which have OS/2 libraries, on
  9.  the IBM NSC BBS, and on CompuServe (OS2USER forum, Library 4).
  10.  
  11.  Zip Control is copyrighted shareware, it is NOT PUBLIC DOMAIN, it is
  12.  NOT FREE.  You are encouraged to use it for a reasonable evaluation
  13.  period (21 days) to see if it is software which is helpful to you
  14.  and which you wish to continue using.  If you do decide to continue
  15.  using Zip Control, you MUST register your copy of Zip Control by
  16.  filling out the form in ORDER.DOC and sending it along with the
  17.  registration fee to RPF Software.
  18.  
  19.  Alternatively, and perhaps easier, you may register using the
  20.  CompuServe online registration service.  The registration fee will
  21.  be added to your CompuServe bill.  To use this method, GO SWREG.
  22.  The registration number is 1373 or search for "RPF Zip Control."
  23.  
  24.  The registration fee is currently US$18.00.
  25.  
  26.  Version 1.10 Features
  27.  ---------------------
  28.  - PM interface for the freeware UNZIP.EXE program.
  29.  
  30.  - "Open" provides standard OS/2 file open dialog box for the user 
  31.    to select which ZIP file to open and then displays the contents
  32.    of the ZIP file in a list box.
  33.  
  34.  - "Settings" - This notebook of settings includes settings for 
  35.    Options, Paths, and Programs.
  36.  
  37.    + "Options" saves user-specified default options:
  38.  
  39.      * "Respect" the stored path(s) in the ZIP file (or not)
  40.    
  41.        "Respect" (the default and recommended), when checked, will 
  42.        unzip the files in the .ZIP file to the target directory, 
  43.        create (if necessary) the relative paths (directories) as 
  44.        subdirectories to the target directory, and properly place 
  45.        the unzipped files in the correct subdirectories.
  46.  
  47.        When "Respect" is NOT checked, the files in the .ZIP file 
  48.        will be placed in the target directory . . . even if the
  49.        intended file paths had been stored in the .ZIP file.
  50.    
  51.      * "Update" existing files and create new ones as needed
  52.      
  53.        "Update" will, during the unzip process, replace existing 
  54.        files of the same name in the target directory IF and ONLY IF
  55.        the files in the .ZIP file have a later creation date than
  56.        the same-named files in the target directory.
  57.  
  58.        "Update" will also, during the unzip process, unzip any files 
  59.        in the .ZIP file which are not in the target directory.
  60.  
  61.      * "Freshen" existing files, but do not create new files
  62.  
  63.        "Freshen" will perform as "Update" (above) does but WILL NOT unzip 
  64.        any files in the .ZIP file which are not in the target directory.
  65.  
  66.        "Freshen" is not compatible with the "Never overwrite" option, 
  67.        since "never overwriting" existing files and not unzipping files
  68.        which do not exist in the target directory leaves nothing for 
  69.        UNZIP.EXE to do.
  70.  
  71.      * "Update" and "Freshen" are mutually exclusive selections.
  72.  
  73.      * With neither "Update" nor "Freshen" selected (the default and 
  74.        recommended), the files ("Selected" or "All") in the .ZIP 
  75.        file will be unzipped to the target directory, REPLACING any
  76.        existing files of the same name, regardless of file creation 
  77.        date, and also unzipping files which do not currently exist in
  78.        the target directory . . . subject to the "Never overwrite" 
  79.        option.
  80.  
  81.      * "Never overwrite" existing files
  82.  
  83.        "Never overwrite" will prevent UNZIP.EXE from unzipping files 
  84.        from the .ZIP file which already exist in the target directory.
  85.  
  86.    + "Paths" saves user-specified default paths
  87.    
  88.      * Directory where ZIP files usually are
  89.      * Directory where ZIP files are usually unzipped into
  90.      * The option to, by default, unzip files into the same directory
  91.        in which each ZIP file is located (rather than using the 
  92.        default output directory)
  93.        
  94.    + "Programs" saves user-specified default programs
  95.    
  96.      * The name and optionally, path of the UNZIP program
  97.      * The name(s) and optionally, path(s) of the program(s) with 
  98.        which you wish to view files stored within the ZIP file.
  99.  
  100.        A default viewer can be defined.  Additionally, specific 
  101.        viewers can be associated with files of user defined file
  102.        extensions.  For example, the viewers E.EXE, EPM.EXE,
  103.        VIEW.EXE, LIST.EXE, and GALLERIA.EXE could be associated with
  104.        <default>, .DOC, .INF, .TXT, and .BMP files respectively.
  105.  
  106.        For ZIP files with embedded ZIP files, you could associate 
  107.        ZIPCNTRL.EXE with the .ZIP files, so that you could "view"
  108.        the contents of embedded ZIP files . . . and so on to 
  109.        multiple depths of viewing.
  110.  
  111.        With due caution, you could associate CMD.EXE /C with .EXE 
  112.        files to run the .EXE program.
  113.  
  114.  - "UnZip" acts on highlighted files in the list box (from the ZIP
  115.    file) or ALL files.  You first have an opportunity to override 
  116.    the defaults listed in "Settings - Options & Paths" above and 
  117.    to override the target directory.  The target directory will 
  118.    be created if it does not exist.  A progress indicator is 
  119.    provided.
  120.  
  121.  - "View" passes all highlighted files in the list box to the
  122.    VIEW program(s) (E.EXE, LIST.EXE, etc.) defined in the 
  123.    Programs page of the Settings notebook.  This means several
  124.    files can be viewed at the same time.
  125.  
  126.    If the SmartView box is checked, each file viewed will be
  127.    viewed using the defined viewer for that type of file.  If the
  128.    box is not checked, the <default> viewer will be used.  The
  129.    default viewer may be helpful for viewing files which have an
  130.    .INF file extension, but are actually plain text files.
  131.  
  132.  - "Print" presents a listing of the files which have been 
  133.    highlighted.  These files can be left selected (for printing)
  134.    or not (will not be printed).  Then the files will be printed
  135.    to the default PRN printer.
  136.  
  137.  - "Comments" displays the embedded Zip file comments, if present.
  138.    The comments window displays automatically if the ZIP file 
  139.    contains comments.
  140.  
  141.  - "Product Information" shows contact information for RPF Software
  142.    and provides a method to enter user name and registration 
  143.    number (received after registration via ORDER.DOC or GO SWREG).
  144.  
  145.  - "Search" is used to build a list of all .ZIP files on one or 
  146.    more disk drives.  The list of files is sorted by name+date+
  147.    path, path+name+date, or date+name+path.  This sort order can 
  148.    be changed at any time, without necessitating a re-search of
  149.    the disk drives.
  150.  
  151.    Individual files in the list may be selected for either 
  152.    deletion (perhaps duplicates) or opening (unzipping).  
  153.  
  154.    All the other Zip Control capabilities are available for ZIP
  155.    files opened from the Search window.
  156.  
  157.  Known Problems
  158.  --------------
  159.  * 4OS2 users may see an extra window at or shortly after startup
  160.    of Zip Control.  This window will contain "ANSI escape sequences"
  161.    (will appear to be garbage text) as a result of commands in a
  162.    4OS2 .CMD file, most likely 4START.CMD.  The commands in this file
  163.    that will cause this condition include CLS, VER, and PROMPT, 
  164.    although any other commands which send ANSI escape sequences to
  165.    the "screen" will cause the same condition.
  166.  
  167.    Until a better solution is available, 4OS2 users may wish to
  168.    move 4START.CMD to a directory which is not in the PATH, such
  169.    as 4Start. For those "icons" which will use an OS/2 
  170.    Command window (OS/2 Window, OS/2 Full Screen, custom .CMD 
  171.    icons), you can add "//4StartPath=C:\4Start\" to the 
  172.    parameters line in the "icon" object (without the quotes).  
  173.    This lets the 4OS2 window and FS sessions use the CLS, Prompt, 
  174.    etc. commands for those sessions where they are needed, but 
  175.    lets Zip Control run without seeing those commands.
  176.    
  177.    This 4OS2 related problem will be corrected in a subsequent 
  178.    release of Zip Control.
  179.  
  180.  Futures
  181.  -------
  182.  Support for ZIP.EXE.
  183.  Use of threads.
  184.  Help buttons/system.
  185.  PkUnZip, PkZIP support.
  186.  User suggestions will be incorporated, as appropriate.
  187.  
  188.  Files Included
  189.  --------------
  190.  ReadMe.doc
  191.  History.doc
  192.  Order.doc
  193.  Warranty.doc
  194.  ZipCntrl.exe
  195.  ZipCntrl.ico
  196.  ZipCntr1.ico
  197.  ZipCntr2.ico
  198.  ZipCntr3.ico
  199.  ZipCntr4.ico
  200.  ZipCntr5.ico
  201.  
  202.  Installation Instructions
  203.  -------------------------
  204.  Unzip the delivery files to a new directory, such as \ZipCntrl.
  205.  Create a workplace shell object which references ZipCntrl.exe
  206.  (with path) as the program name and enter the same path as
  207.  the working directory.
  208.  
  209.  Run Zip Control by either double clicking on the Zip Control
  210.  object on the desktop OR by dragging one or more .ZIP files
  211.  to the Zip Control desktop object (using the right mouse
  212.  button).  If multiple .ZIP files are dragged to the Zip Control 
  213.  object, multiple versions of Zip Control will be started, each 
  214.  on top of the other.  You can then use these to perform 
  215.  simultaneous unzips or to investigate the various .ZIP files, 
  216.  comparing dates of zipped files, and viewing zipped files.
  217.  
  218.  Use the "Paths" page of the "Settings" notebook in Zip Control 
  219.  to define the path where .ZIP files will usually be found, 
  220.  such as C:\DOWNLOAD.  Also, define a default output directory, 
  221.  such as C:\SCRATCH.  
  222.  
  223.  Note:  The default output directory is used for Zip Control
  224.  temporary files created when using "View."  The temporary
  225.  files should be automatically cleaned up.  However, if they
  226.  are not automatically deleted, you may delete them at any time.  
  227.  The temporary files begin with "~ZIP."
  228.  
  229.  You may wish to create a "shadow" of your default output 
  230.  directory (e.g., C:\SCRATCH) on your desktop and have it open
  231.  when using Zip Control.  As you unzip each .ZIP file, the 
  232.  unzipped files will appear in the output directory on your
  233.  desktop where you can either test run the unzipped application
  234.  or otherwise evaluate the files.  Then, when you no longer
  235.  want those unzipped files, you can graphically "select" all
  236.  (or some) of the unzipped files and delete them.
  237.  
  238.  Advanced users may wish to create a Zip Control work area (folder)
  239.  on the desktop, containing open shadows of Zip Control, the 
  240.  default .ZIP directory, and the default output directory.  Rather
  241.  than closing Zip Control, close the Zip Control work area while
  242.  the application is still running.  Thereafter, when you open
  243.  the Zip Control work area, Zip Control will start automatically,
  244.  and the two working directory folders will reopen where you last 
  245.  left them.
  246.  
  247.  Why so many .ICO files?
  248.  -----------------------
  249.  ZIPCNTRL.ICO is used as the icon for ZIPCNTRL.EXE.  The files  
  250.  ZIPCNTRn.ICO are used for the "animation" in the Product
  251.  Information dialog box.  Any or all of the .ICO files may be
  252.  deleted to save disk space since they are not necessary to 
  253.  the program.  
  254.  
  255.  Alternatively, you can substitute your own icons for mine as
  256.  long as you name them ZIPCNTRn.ICO, where n is a number from
  257.  1 to 9 and the numbers are consecutive.  You can use 0, 1, or up 
  258.  to 9 .ICO files for the animation.
  259.                                    
  260.  ------------------ Contact Information for Support -------------------
  261.  Attn:  Richard Fortson              FAX:  404.250.0282
  262.  RPF Software                        CompuServe:  71660,535
  263.  P.O. Box 420457
  264.  Atlanta, GA  30342
  265.  
  266.  --------------------------
  267.  "Support OS/2 development"
  268.  --------------------------
  269.  
  270.